home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / hdf / specs / hdfspecs.lha / HDFSpecs.intro < prev    next >
Text File  |  1992-03-04  |  5KB  |  148 lines
  1. i    NCSA HDF Specifications
  2.  
  3. Introduction    i
  4.  
  5. National Center for Supercomputing Applications
  6.  
  7. March 1989
  8.  
  9.                                                                 
  10.  
  11. March 1989
  12.  
  13.  
  14.  
  15.  
  16.  
  17. Introduction
  18.  
  19.  
  20.  
  21.  
  22.  
  23. Overview
  24.  
  25. At the National Center for Supercomputing Applications, diverse 
  26. groups are working on supercomputing projects of many kinds. 
  27. The Hierarchical Data Format (HDF) was designed to make the 
  28. sharing of data between different people, different projects, and 
  29. different types of computers easy and self-describing. An 
  30. extensible header, along with carefully crafted internal layers, 
  31. provides a system that can grow along with the software that NCSA 
  32. develops. This chapter provides a brief overview of HDF 
  33. capabilities and design.
  34.  
  35.  
  36. What Is HDF?
  37.  
  38. HDF is a growth-oriented approach to file format design. Rather 
  39. than try to address all of the short-term issues in a fixed format, or 
  40. attempt to solve all of the hard problems in an all-purpose format, 
  41. HDF defines a framework for continued future growth. New 
  42. calling interfaces can be defined that are compatible with old ones. 
  43. Files can be made upwardly compatible for years to come without 
  44. giving up added power in the future. HDF also makes it easy for 
  45. the user to include annotations, titles, and specific descriptions of 
  46. the data in the file, so that files can be archived with human-
  47. readable information about their origins.
  48.  
  49. HDF uses the concept of a tagged, or object oriented, file 
  50. organization. The idea is to store both a known format description 
  51. and the data in the same file. HDF tags describe the format of the 
  52. data because each tag is assigned a specific meaning╤one tag is 
  53. assigned to "File Identifier," another is assigned to "Raster 
  54. Image," and so on (see Figure 1). A program that has been written 
  55. to understand a certain list of tag types can scan the file for those 
  56. tag types and process the data. This program also can ignore any 
  57. data that is beyond its scope.
  58.  
  59.  
  60. Figure 1    Raster Image Sets in an HDF File
  61.  
  62.                                                  
  63.  
  64.  
  65. HDF files never need to become out of date. For example, suppose a 
  66. site falls far behind in the HDF standard, so its users can only 
  67. work with the portions of the specification that are three years old. 
  68. Users at this site might want to import files from NCSA. Even with 
  69. the more advanced data files, they can list the types of data in the 
  70. file. All of the older types of data objects that they understand are 
  71. still accessible, despite the fact that the older types of data objects 
  72. are mixed in with new kinds of data. In addition, if the more 
  73. advanced site uses the text annotation facilities of HDF effectively, 
  74. the files will arrive with complete human-readable descriptions of 
  75. how to decipher the new tag types.
  76.  
  77. To present a convenient user interface made up of something other 
  78. than a list of tag types with their associated data requirements, 
  79. HDF supports multiple calling interfaces. The low level calling 
  80. interface for manipulating tags and raw data is designed to be 
  81. used by systems programmers who are providing the higher level 
  82. interfaces for applications like raster image storage or scientific 
  83. data archiving.
  84.  
  85. An important issue in data file design is that of machine 
  86. independence or transportability. The HDF design is not machine 
  87. independent, but it defines the data completely. HDF requires you 
  88. to fully specify all number types used, so conversion programs can 
  89. identify what number formats are being used and do the 
  90. conversions when needed.
  91.  
  92.  
  93. Use of This Manual
  94.  
  95. This manual is designed for software developers who are 
  96. designing applications or routines for use with HDF files and for 
  97. users who need detailed information about HDF.
  98.  
  99.  
  100. Manual Contents
  101. The manual is organized into the following chapters:
  102.  
  103. Chapter 1, "The Basic Structure of HDF Files," introduces and 
  104. describes the components and organization of Hierarchical Data 
  105. Format files.
  106.  
  107. Chapter 2, "The NCSA HDF General Purpose Interface," contains 
  108. a list of the routines that make up the low level interface described 
  109. in detail in the HDF manual.
  110.  
  111. Chapter 3, "Sets and Groups," describes raster image sets and 
  112. scientific datasets, explains the role of sets and groups in an HDF 
  113. file, and discusses the routines that are available for storing and 
  114. retrieving scientific datasets.
  115.  
  116. Chapter 4, "HDF Conventions," presents guidelines regarding the 
  117. use of HDF that are not discussed elsewhere.
  118.  
  119. Chapter 5, "Other Formats," briefly describes the following 
  120. formats and compares their features with those of HDF:  CGM, 
  121. PICT2, TIFF, CDF, FITS, PHIGS, and PHIGS+.
  122.  
  123. Appendix A, "NCSA HDF Tags," presents a list of brief 
  124. descriptions of the tags assigned at NCSA for general use.
  125.  
  126. Appendix B, "Header Files," includes the general header files 
  127. used in compiling all HDF libraries.
  128.  
  129.  
  130. Form of Presentation
  131. The material in this manual is presented in text or screen displays.
  132.  
  133.  
  134. Text
  135. In explaining various features and commands, this manual often 
  136. presents a word within a paragraph in italics to indicate that the 
  137. word is defined within the paragraph.
  138.  
  139. Portions of this manual refer to other portions of the manual where 
  140. the other portions explain related topics. These cross references 
  141. usually mention the title of sections or chapters enclosed in 
  142. quotation marks, such as, See Chapter 1, "The Basic Structure of 
  143. HDF Files."
  144.  
  145.  
  146. Screen Displays
  147. Screen displays in this manual are presented in courier type.
  148.